﻿XV40 BongoCat Mod — 二次开发版
打包时间：2026-11-10 11:27
适配游戏：V2.7.4+b26538670（2026-11-10 11:06 更新）
DLL SHA256：1428A5C75A0BEBE90CDD1E537A5464A5220E465E0C464BD29B7909B9BB3FDA63

====================================================================
这是什么
====================================================================
给 Steam 版 BongoCat 用的 Mod，按 F7 打开面板。主要功能：

* 可视化键盘 —— 猫咪下面出现一块键盘，你真实敲键盘时对应的键会
  按下去，猫爪按键位左右手区分。皮肤可切换，也可以自己做。
* 打字统计 —— 实时 APM、今日与累计按键数、最常用的按键、
  左右手比例，还有按使用频次染色的键盘热力图。
* 挂机收益 —— 统计你挂机期间新增了哪些物品，带图标和品质边框。
* 房间掉落 —— 在联机房间里看到每个成员获得了什么物品。
* 宝箱自动化 —— 自动开箱、免费开箱、解除掉落上限、隐藏宝箱图标等。
* 联机工具 —— 房间成员列表、帮好友开箱、配置与预设导入导出。

====================================================================
安装步骤（推荐：一键安装）
====================================================================
把压缩包整个解压出来，双击里面的「一键安装.bat」即可。

它会自己找到游戏目录、核对游戏版本、检查游戏有没有在运行、备份原版
DLL、复制 Mod。中途如果发现游戏还开着，会提示你关闭。

安装器不会在你电脑上建任何文件夹。本包不带键盘皮肤，想要更多皮肤去 Mod 站下载：
    https://mod.okamix.cn/shares
（游戏里 F7 → 键盘，最上面那一行点「前往」也能直接打开。）
下载的皮肤要放进 Mod 的「数据目录」，这个目录默认是关的 —— 见下面「数据目录」。

Mod 是跟游戏那一版的代码一起编译出来的，版本对不上装进去会闪退，
所以安装器会先核对版本，对不上就直接停下，不动你的游戏文件：

* 提示「请先把游戏更新到最新版」—— 你的游戏太旧，去 Steam 更新一下。
* 提示「游戏已经更新，Mod 还没跟上」—— 适配新版的 Mod 会第一时间发布在 Mod 站：
      https://mod.okamix.cn/mods/bongocat
  （第一次打开要输访问口令，口令在群公告里。）
  在这个页面登录后点「订阅更新」，以后 Mod 一更新，就会马上发 QQ 邮件和
  站内消息通知你，不用再自己去翻找。在那之前游戏是干净的，照常玩就行。

想卸载就双击「一键卸载.bat」，它会把原版还原回去。

====================================================================
安装步骤（手动，一键安装用不了时再看这个）
====================================================================
1. 完全退出 BongoCat（托盘图标也要退出）。

2. 打开游戏安装目录下的：
       BongoCat_Data\Managed\
   在 Steam 里右键 BongoCat → 管理 → 浏览本地文件，即可找到。

3. **先备份**：把里面原来的 Assembly-CSharp.dll 复制一份，
   改名成 Assembly-CSharp.dll.备份 留在原地。
   这一步别跳过，出问题就靠它还原。

4. 把本压缩包里的 Assembly-CSharp.dll 复制进去，覆盖原文件。

5. 启动游戏。

想要键盘皮肤：在面板里打开「数据 → 数据目录」，把从 Mod 站下载的皮肤文件夹
复制到该面板显示的目录下的 keyboard\ 里（默认是 桌面\XV40Mod导出\keyboard\）。
数据目录没开的话，Mod 不会读也不会建这个文件夹。

手动装没有版本核对，请自己确认游戏版本就是上面写的那个。

====================================================================
数据目录（键盘皮肤、导出的配置、打字统计都放这儿）
====================================================================
Mod 默认不往你的电脑上写任何文件，也不建文件夹。需要下面这些功能时
再打开它：键盘皮肤、导出/导入配置和预设、打字统计存盘、导出聊天记录。

打开方法：F7 → 配置与预设 → 数据目录 → 点亮「启用数据目录」。
默认位置是 桌面\XV40Mod导出，想换地方就在同一个面板里：
在输入框里粘贴一个文件夹路径按回车，或者先在资源管理器里复制路径
（地址栏点一下 Ctrl+C，或对文件夹按 Shift+右键 →「复制为路径」），
再点「粘贴剪贴板」。只有开着的时候才能改位置。

键盘皮肤从 Mod 站下载后，放进数据目录下的 keyboard\ 里，每套一个子文件夹，
再在键盘页点「重新读取素材」。

合照的背景图不随包发 —— 那是整屏尺寸的图，一张就上十几 MB，而且
每个人想要的不一样。自己放：F7 → 合照 → 拍照 → 背景素材 → 「打开目录」，
把图丢进去再点「重新扫描」。不放就用纯色底，不影响拍照。

不想要了：把开关关掉。目录是空的会直接删掉；里面还有东西的话会告诉你
有几套皮肤、几个文件，点「删除数据目录」再点一次确认才真删 ——
删除不进回收站，自己做的皮肤记得先拷走。

====================================================================
怎么用
====================================================================
1. 先打开一次游戏的"设置"页。这一步是必须的 —— 面板的所有控件
   都是克隆设置页里的按钮做模板，没打开过就建不出面板。
   每次重启游戏后都要先打开一次。
2. 按 F7 打开 Mod 面板。

键盘：
  快捷操作 → 键盘设置 → 打开"显示键盘"和"按键决定左右爪"。
  面板打开时可以直接用鼠标拖动键盘摆位，也可以用
  "水平偏移 / 垂直偏移 / 键盘缩放 / 透视强度 / 键盘错切"微调。
  反复点"键盘皮肤"在内置和各套皮肤之间切换。

打字统计：
  键盘设置 → 打字统计。数据每 30 秒自动存盘，不用手动导出。

挂机收益：
  快捷操作 → 挂机收益。基准会在库存就绪后自动建立，
  最多等 30 秒；刚进游戏就打开可能显示"等待库存"。

房间掉落：
  快捷操作 → 联机与数据工具。房间成员行的第二行会显示他们
  获得的物品，点一下图标条看完整清单。
  只统计你在房间里的这段时间，看不到历史。

更多键盘皮肤、装扮素材：
  https://mod.okamix.cn/shares

====================================================================
重要提醒
====================================================================
* 游戏缩放请保持 100%。放大或缩小猫咪时键盘不会正确跟随，
  这是已知问题。

* 这个 DLL 是针对 V2.7.4+b26538670（2026-11-10 11:06 更新） 编译的。游戏一更新代码就变了，
  旧 Mod 装上去可能猫咪不出现或直接闪退。一键安装器会替你拦住
  这种情况；万一已经装进去了，把第 3 步的备份文件改回
  Assembly-CSharp.dll 即可完全还原。

* 想卸载：同样用备份文件覆盖回去就行，不影响存档和 Steam 物品。

* 装 Mod 不会影响 Steam 库存、成就或联机。但联机时对方看到的
  是他自己选的皮肤，看不到你选的，也看不到你按的具体是哪个键 ——
  游戏本身只同步敲击次数。

====================================================================
自己做皮肤
====================================================================
键盘设置 → "导出素材模板"，会在 桌面\XV40Mod导出\keyboard\ 下
生成一套名为"模板"的皮肤，里面有可直接修改的 layout.json、
图片，以及每个字段的详细中文说明。

规则：keyboard 目录下每一个含 layout.json 的子目录 = 一套皮肤，
子目录名就是游戏里显示的皮肤名。改完点"重新读取素材"刷新。